home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 301-325 / disk_319 / cnewssrc / cnews.orig.lzh / man / newsaux.man < prev    next >
Text File  |  1989-06-28  |  11KB  |  265 lines
  1.  
  2.  
  3.  
  4.      NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))            CCCC NNNNeeeewwwwssss ((((9999 JJJJuuuunnnneeee 1111999988889999))))             NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           spacefor - check available space for news
  10.           queuelen - get length of outbound-news uucp queues
  11.           sizeof - get size of file(s) for news
  12.           ctime, getdate - convert dates to and from internal
  13.           representation for news
  14.           newshostname - get host name for news
  15.           gngp - search text using a newsgroup pattern
  16.           newshist - extract history line for news article(s)
  17.           newslock - do locking for news
  18.           newsdaily - maintain news log files and report problems
  19.           newswatch - keep an eye on news system for difficulties
  20.           newsboot - clean up news debris on reboot
  21.           locknews - lock news system for manual tinkering
  22.           addgroup, delgroup - add and delete newsgroups, locally only
  23.  
  24.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  25.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ssssppppaaaacccceeeeffffoooorrrr filesize location [ site ]
  26.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////qqqquuuueeeeuuuueeeelllleeeennnn site
  27.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ssssiiiizzzzeeeeooooffff file ...
  28.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ccccttttiiiimmmmeeee decimaldate
  29.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ggggeeeettttddddaaaatttteeee printabledate
  30.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////nnnneeeewwwwsssshhhhoooossssttttnnnnaaaammmmeeee
  31.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ggggnnnnggggpppp [ ----aaaa ] ngpattern file ...
  32.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////nnnneeeewwwwsssshhhhiiiisssstttt msgid ...
  33.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////nnnneeeewwwwsssslllloooocccckkkk locktemp lockname
  34.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////nnnneeeewwwwssssddddaaaaiiiillllyyyy [ guru ... ]
  35.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////nnnneeeewwwwsssswwwwaaaattttcccchhhh [ guru ... ]
  36.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////nnnneeeewwwwssssbbbbooooooootttt
  37.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////lllloooocccckkkknnnneeeewwwwssss
  38.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////aaaaddddddddggggrrrroooouuuupppp group {yyyy|nnnn|mmmm|xxxx|====_r_e_a_l_g_r_o_u_p}
  39.           ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////mmmmaaaaiiiinnnntttt////ddddeeeellllggggrrrroooouuuupppp group
  40.  
  41.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  42.           These programs are minor utilities used by various parts of
  43.           C News.
  44.  
  45.           _S_p_a_c_e_f_o_r determines how many files of size _f_i_l_e_s_i_z_e can fit
  46.           in _l_o_c_a_t_i_o_n (iiiinnnnccccoooommmmiiiinnnngggg, aaaarrrrttttiiiicccclllleeeessss, ccccoooonnnnttttrrrroooollll, aaaarrrrcccchhhhiiiivvvveeee, or
  47.           oooouuuuttttbbbboooouuuunnnndddd to _s_i_t_e) without cramping things unduly.  The
  48.           precise locations of these places, and how low space gets
  49.           before it is unduly cramped, are site-specific.  _S_p_a_c_e_f_o_r
  50.           invokes _d_u(1) to determine the available space.
  51.  
  52.           _Q_u_e_u_e_l_e_n reports how many news batches _u_u_c_p has queued up
  53.           for _s_i_t_e.
  54.  
  55.           _S_i_z_e_o_f reports the total number of bytes in the _f_i_l_e(s).
  56.           (This may seem redundant with _l_s -_l, but the format of _l_s -_l
  57.           varies between systems and _s_i_z_e_o_f looks after all that.)
  58.  
  59.           _C_t_i_m_e and _g_e_t_d_a_t_e convert dates in human-readable form to
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/29/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))            CCCC NNNNeeeewwwwssss ((((9999 JJJJuuuunnnneeee 1111999988889999))))             NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))
  71.  
  72.  
  73.  
  74.           (_g_e_t_d_a_t_e) and from (_c_t_i_m_e) decimal ASCII representations of
  75.           Unix's internal integer dates.  Their functionality
  76.           resembles that of their namesakes in the C library.
  77.  
  78.           _N_e_w_s_h_o_s_t_n_a_m_e reports the name of this system for news
  79.           purposes.  This may differ from the name of the particular
  80.           CPU it is run on; a cluster of CPUs sharing a filesystem
  81.           tree would all have the same _n_e_w_s_h_o_s_t_n_a_m_e name.  Typically
  82.           _n_e_w_s_h_o_s_t_n_a_m_e gets the name from /_u_s_r/_l_i_b/_n_e_w_s/_w_h_o_a_m_i;
  83.           failing that, it consults various other possible sources
  84.           (e.g. the _h_o_s_t_n_a_m_e command).
  85.  
  86.           _G_n_g_p resembles _g_r_e_p except that its search is based on
  87.           newsgroup patterns (e.g. `comp', which matches `comp',
  88.           `comp.lang', `comp.lang.c', ...; `comp,!comp.lang.c' which
  89.           matches `comp' and `comp.lang' but not `comp.lang.c'; etc.).
  90.           _G_n_g_p prints only the line(s) that contain a substring that
  91.           matches the _n_g_p_a_t_t_e_r_n.  Normally the substring must run from
  92.           a point in the line to its end.  If the ----aaaa flag is given,
  93.           the eligible substrings start at the beginning of the line
  94.           and end at white space or the end of the line.
  95.  
  96.           _N_e_w_s_h_i_s_t prints the history line for each article identified
  97.           by a _m_s_g_i_d.
  98.  
  99.           _N_e_w_s_l_o_c_k makes a link named _l_o_c_k_n_a_m_e to the file _l_o_c_k_t_e_m_p,
  100.           and returns exit status 0 for success, 1 if the link could
  101.           not be made (typically because _l_o_c_k_n_a_m_e already existed).
  102.           This is used for shell-file locking in C News.  It is a
  103.           subset of _l_n(1) except that (a) no error messages are ever
  104.           produced and (b) the link is guaranteed to fail if _l_o_c_k_n_a_m_e
  105.           already exists.  (Some brain-damaged versions of _l_n
  106.           helpfully remove _l_o_c_k_n_a_m_e in that case, making them useless
  107.           for locking.)
  108.  
  109.           _N_e_w_s_d_a_i_l_y performs minor maintenance chores that typically
  110.           should be done once a day for the news system: saving copies
  111.           of log files and truncating them, reporting logged errors,
  112.           and checking for anomalies suggesting something is wrong.
  113.           _N_e_w_s_d_a_i_l_y saves one generation of old _l_o_g files and three
  114.           generations of old _e_r_r_l_o_g files.  It reports problems to the
  115.           named _g_u_r_us (default:  `usenet').
  116.  
  117.           _N_e_w_s_w_a_t_c_h looks for indications of news problems on a
  118.           shorter time scale than those reported by _n_e_w_s_d_a_i_l_y, notably
  119.           strangely-persistent lock files that may indicate a news-
  120.           system failure.  It typically should be run a few times a
  121.           day.
  122.  
  123.           _N_e_w_s_b_o_o_t should be run from /_e_t_c/_r_c or the system's
  124.           equivalent on reboot.  It cleans up files that the news
  125.           system might have left lying about if the system crashed
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/29/89)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))            CCCC NNNNeeeewwwwssss ((((9999 JJJJuuuunnnneeee 1111999988889999))))             NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))
  137.  
  138.  
  139.  
  140.           while news was being processed, notably old lock files.
  141.  
  142.           _L_o_c_k_n_e_w_s locks the news system, starts up a shell for the
  143.           user, and waits around to unlock the news system when that
  144.           shell terminates.  This simplifies manual maintenance.
  145.  
  146.           _A_d_d_g_r_o_u_p and _d_e_l_g_r_o_u_p respectively add a newsgroup (with a
  147.           specified flags field for the _a_c_t_i_v_e file, normally `y' [see
  148.           _n_e_w_s(5)]) and delete a newsgroup manually, with proper
  149.           locking.  The effect is purely local; no control message (to
  150.           propagate the change to other machines) is sent.
  151.  
  152.      FFFFIIIILLLLEEEESSSS
  153.           /usr/spool/uucp/*       uucp queues
  154.           /usr/lib/news/whoami    news host name
  155.           /usr/lib/news/history   history file
  156.           /usr/lib/news/history.pag_d_b_m database for history file
  157.           /usr/lib/news/history.dir_d_b_m database for history file
  158.           /usr/lib/news/L.*       lock temporaries
  159.           /usr/lib/news/LOCK*     lock files
  160.           /usr/lib/news/log       current news log
  161.           /usr/lib/news/log.o     previous news log
  162.           /usr/lib/news/errlog    current news-error log
  163.           /usr/lib/news/errlog.o* old news-error logs
  164.           /usr/spool/news/in.cominginput-spooling area
  165.           /usr/spool/news/out.goingoutput-batching area
  166.           /usr/lib/news/watchtime last time _n_e_w_s_w_a_t_c_h was run
  167.           /usr/lib/news/active    list of current newsgroups
  168.           /usr/lib/news/active.oldbackup copy created by _a_d_d_g_r_o_u_p and _d_e_l_g_r_o_u_p
  169.  
  170.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  171.           df(1), uucp(1), ls(1), ctime(3), getdate(3), hostname(1),
  172.           grep(1), news(5), expire(8), newsbatch(8), rnews(8)
  173.  
  174.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  175.           _L_o_c_k_n_e_w_s complains and exits if it is unable to lock the
  176.           news system; this is typically a matter of either inadequate
  177.           permissions or news activity already in progress.
  178.  
  179.      HHHHIIIISSSSTTTTOOOORRRRYYYY
  180.           Written at U of Toronto by Henry Spencer and Geoff Collyer.
  181.  
  182.      BBBBUUUUGGGGSSSS
  183.           _S_p_a_c_e_f_o_r and _q_u_e_u_e_l_e_n are unfortunately somewhat system-
  184.           specific, since _d_u output and _u_u_c_p file layout vary between
  185.           different versions.
  186.  
  187.           The need for _s_i_z_e_o_f and _n_e_w_s_l_o_c_k is a botch.
  188.  
  189.           _L_o_c_k_n_e_w_s is a bit crude.
  190.  
  191.           _A_d_d_g_r_o_u_p does not create the directory(-ies) for the new
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 6/29/89)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))            CCCC NNNNeeeewwwwssss ((((9999 JJJJuuuunnnneeee 1111999988889999))))             NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))
  203.  
  204.  
  205.  
  206.           group; C News creates them as necessary but some news-reader
  207.           programs disapprove.
  208.  
  209.           _D_e_l_g_r_o_u_p does not remove files or directories from
  210.           /usr/spool/news, although it prints a reminder to do so.
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 6/29/89)
  262.  
  263.  
  264.  
  265.